home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d8 / usrlst13.arc / USERLIST.MAN < prev   
Text File  |  1991-07-10  |  7KB  |  201 lines
  1.  
  2.  
  3.  
  4. USERLIST (c) 1991 Stan M. Edmister                                     page 1
  5. -----------------------------------------------------------------------------
  6.                                                           Post Office Box 434
  7.                                                           Eldorado, IL  62930
  8.              Version 1.3                                         USA
  9.  
  10.              July 7, 1991                                 618-273-5093  VOICE
  11.  
  12.  
  13.  
  14.  
  15. USERLIST is a program written for Executive Host (c) to list your registered
  16. users in both ASCII and ANSI bulletins.
  17.  
  18. USERLIST is a copyrighted program, but it may be used free of charge.
  19.  
  20. However, USERLIST may not be sold or otherwise commercially distributed
  21. (except by John Wright, of Marion, IL).  Likewise, without written permission
  22. from me, it must remain in its original form, and cannot be duplicated and
  23. sold or otherwise commercially distributed in an altered state, including,
  24. but not limited to, distributed under a different name or crediting another
  25. person as its author.
  26.  
  27. The author expresses no warranty (especially since ya' didn't pay for it!)
  28. and cannot guarantee the results once executed.
  29.  
  30.  
  31. -----------------------------------------------------------------------------
  32.  
  33.  
  34.   FILES
  35.   =====
  36.  
  37.  
  38. The following files are included in the USERLIST package:
  39.  
  40.           729 bytes, USERHDR.       Sample ASCII header file (see below)
  41.           939 bytes, USERHDRG.      Sample ANSI  header file (see below)
  42.         6,647 bytes, USERLIST.MAN   This manual
  43.      * 21,681 bytes, USERLIST.EXE   USERLIST Program
  44.  
  45.             The program creates 2 files, USERBUL.   (the ASCII bulletin)
  46.                                      and USERBULG.  (the ANSI bulletin)
  47.  
  48.    (If the files in your package have DIFFERENT lengths than these, it might
  49.     mean that they have been infected by a VIRUS.  DO NOT use them!
  50.     DELETE them immediately and contact the SySop of the board where you
  51.     downloaded them.  I will be glad to mail anybody a copy of USERLIST.)
  52.  
  53.  
  54. -----------------------------------------------------------------------------
  55.  
  56.  
  57. The output of USERLIST is sorted by NAME or DATE (of initial registration),
  58. and can be forced to be in ALL-CAPS.
  59.  
  60. The ASCII bulletin file is named   USERBUL.
  61. The ANSI  bulletin file is named   USERBULG.
  62.  
  63. Copy both files to your Executive Host program directory (where TELIX is) and
  64. make an entry in BULLETIN.DAT just like you would for any other bulletin!
  65.  
  66.  
  67.  
  68.  
  69.  
  70. USERLIST (c) 1991 Stan M. Edmister                                     page 2
  71. -----------------------------------------------------------------------------
  72.  
  73.  
  74.   SWITCHES
  75.   ========
  76.  
  77.  
  78. The syntax for USERLIST is:
  79.  
  80.  
  81.                USERLIST {/switches}              ; switches are optional
  82.  
  83.  
  84. The available switches are:
  85.  
  86.                /U  -  Make the bulletins in uppercase only
  87.                /N  -  Sort the output by name (default)
  88.                /D  -  Sort the output by date (of initial registration)
  89.                /C  -  List the output on screen too (still creates files)
  90.                /S  -  Use the built-in standard headers
  91.          /H or /?  -  Help screen
  92.  
  93.                   Any other switches will be ignored.
  94.  
  95.          -----------------------------------------------------
  96.  
  97. For example, to get your bulletins in uppercase-only, sorted by date, and
  98. to be able to watch it build, enter:
  99.  
  100.                               USERLIST /UDC
  101.  
  102. To use the standard header (see below, under "HEADERS") and sorted by name:
  103.  
  104.                               USERLIST /NS
  105.  
  106.  
  107. You may consider executing USERLIST in EVENT.BAT, to rebuild your user list
  108. each day.
  109.  
  110.  
  111. -----------------------------------------------------------------------------
  112.  
  113.  
  114.   HEADERS
  115.   =======
  116.  
  117.  
  118. Built into USERLIST is the ability for you to specialize your member lists.
  119. Included in this package are two sample header files (one for ASCII and the
  120. other for ANSII, named  USERHDR.   and  USERHDRG.   , respectively.)
  121.  
  122. Also built into USERLIST is the ability to produce a standard header.
  123.  
  124.     *  A header is the output displayed first, before the user list.
  125.  
  126. If you want to make your own ASCII header, use any editor.
  127.  
  128. To make an ANSI header, you will probably have to use a special ANSI editor
  129. (such as TheDraw).
  130.                      (  c o n t i n u e d  )
  131.  
  132.  
  133.  
  134.  
  135. USERLIST (c) 1991 Stan M. Edmister                                     page 3
  136. -----------------------------------------------------------------------------
  137.  
  138.  
  139. If you want to use the built-in header files, either specify the /S switch
  140. or simply delete both USERHDR.   and USERHDRG.   files.
  141.  
  142.  
  143. (I suggest you simply type USERLIST the first time, then when you look at
  144. the bulletins created (USERBUL & USERBULG, remember?) -- you'll know  what
  145. a "header" is.)
  146.  
  147.      (Note:  You can make your header files any length you want (depending
  148.              on how long you want that poor guy running at 300 to wait!)
  149.              but you really should keep them less than 79 characters wide.)
  150.  
  151.  
  152. -----------------------------------------------------------------------------
  153.  
  154.  
  155.   VERSION HISTORY
  156.   ===============
  157.  
  158.   Version 1.0  -  Released February 19, 1991.
  159.  
  160.   Version 1.1  -  Released February 20, 1991.  OOOPPS - made a typo in my
  161.                   quick-sort!
  162.  
  163.   Version 1.2  -  Released February 23, 1991.  Changed internal structure
  164.                   so that the number of guests is only limited by your
  165.                   free RAM.
  166.  
  167.   Version 1.3  -  Released July 7, 1991.  Fixed error that botched up long
  168.                   names.
  169.  
  170. -----------------------------------------------------------------------------
  171.  
  172.  
  173.   WHY??
  174.   =====
  175.  
  176. The reason I wrote USERLIST is mainly to aquaint myself better with C.
  177.  
  178. I've been programming in COBOL for several years (on a IBM S/34 mini) and
  179. enjoy the structured data types, but I yearned for just a little more
  180. flexibility.
  181.  
  182. For some reason or another, I never liked PASCAL that much (it was like
  183. having that GET-OUT-OF-MY-WAY-POWER and finding out otherwise), and
  184. just when I thought I had ASSEMBLY down, I started finding out how much
  185. I took for granted those simple little things built into COBOL.
  186.  
  187. Therefore, C was an obvious choice.
  188.  
  189.  
  190. If you'd like to change anything -- just let me know!
  191.  
  192. (The way I see it, the more I have to re-program, the exponentially more I
  193. learn)
  194.  
  195. Don't want money.  Got money.  Want ideals.
  196.  
  197. So drop me a note -- let me know what you think.
  198.  
  199.  
  200.                                       Stan M. Edmister
  201.